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ABOUT THIS CHAPTER 


This chapter describes the Binary-Decimal Conversion Package, which contains 
five routines. One converts an integer from its internal (binary) form to a 
string that represents its decimal (base 10) value; the other converts a decimal 
string to the corresponding integer. 


Three new routines have been added to the Binary-Decimal Conversion Package for 
the Macintosh Plus. These routines supplement the Floating-Point Arithmetic and 
Transcendental Functions Packages in providing the the Standard Apple Numeric 
Environment (SANE) for the Macintosh. 


Detailed documentation for these new routines is included with the rest of the 
SANE documentation in the Apple Numerics Manual—in particular, see the chapter 
"Conversions" in Part I and the three chapters "Conversions", "Numeric Scanner 
and Formatter", and "Examples" in Part III. 


The new routines, two numeric scanners and a numeric formatter, are intended for 
programmers with special needs beyond what their development language provides. 
For example, developers of programming languages can use these routines to 
implement the floating-point I/O routines—such as read and write for Pascal or 
scanf and printf for C—that are appropriate for their particular languages. The 
scanners can be used for scanning numbers embedded in text and for numbers 
received character by character. The scanners differ only in that one accepts a 
pointer to a Pascal strings (with an initial length byte) as input, while the 
other accepts a pointer to the first character of a character stream. 


The scanners convert ASCII string representations of numbers into SANE decimal 
records. The formatter converts SANE decimal records into ASCII string 
representations. The Floating-Point Arithmetic Package converts between this 
decimal record format and the SANE binary data formats. 


The three routines handle the usual number representations, like —1.234 and 
5e-7, throughout the range and precision of the extended data format. They also 
handle the special NaN, infinity, and signed-zero representations specified by 
the IEEE Floating-Point Standard. 


You should already be familiar with packages in general, as described in the 
Package Manager chapter. 
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BINARY -DECIMAL CONVERSION PACKAGE ROUTINES 


The Binary-Decimal Conversion Package is contained in the ROM, beginning with 
the 128K ROM. The routines are register-based, so the Pascal form of each is 
followed by a box containing information needed to use the routine from assembly 
language. 


Assembly-language note: The trap macro for the Binary-Decimal Conversion 
Package is Pack7. The routine selectors are as 


follows: 
numToSt ring .EQU 0 
stringToNum .EQU 1 


PROCEDURE NumToString (theNum: LONGINT; VAR theString: Str255); 


On entry AQ: pointer to theString (preceded by length byte) 
DO: theNum (long word) 
On exit AQ: pointer to theString 


NumToString converts theNum to a string that represents its decimal value, and 
returns the result in theString. If the value is negative, the string begins 
with a minus sign; otherwise, the sign is omitted. Leading zeroes are 
Suppressed, except that the value 0 produces '0'. For example: 


theNum theString 
12 “2 
—23 '-23' 
0 '0' 


PROCEDURE StringToNum (theString: Str255; VAR theNum: LONGINT); 


On entry AQ: pointer to theString (preceded by length byte) 
On exit DO: theNum (long word) 


Given a string representing a decimal integer, StringToNum converts it to the 
corresponding integer and returns the result in theNum. The string may begin 
with a plus or minus sign. For example: 


theString theNum 
'12' 12 
'—23' —23 
'—Q' 0 
'055' 55 


The magnitude of the integer is converted modulo 2%32, and the 32-bit result is 
negated if the string begins with a minus sign; integer overflow occurs if the 
magnitude is greater than 2%31-1. (Negation is done by taking the two's 
complement—reversing the state of each bit and then adding 1.) For example: 
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theString theNum 


'2147483648' (magnitude is 2%31) —2147483648 
'-2147483648 ' —2147483648 
'4294967295' (magnitude is 2%32-1) -l1 
'-4294967295 ' 1 


StringToNum doesn't actually check whether the characters in the string are 
between '0' and '9'; instead, since the ASCII codes for '0' through '9' are $30 
through $39, it just masks off the last four bits and uses them as a digit. For 
example, '2:' is converted to the number 30 because the ASCII code for ':' is 
$3A. Spaces are treated as zeroes, since the ASCII code for a space is $20. 
Given that the ASCII codes for 'C', 'A', and 'T' are $43, $41, and $54, 
respectively, consider the following examples: 


theString theNum 
'CAT' 314 
'+CAT ! 314 
'"—CAT' —314 
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SUMMARY OF THE BINARY-DECIMAL CONVERSION PACKAGE 


Routines 


PROCEDURE NumToString (theNum: LONGINT; VAR theString: Str255); 
PROCEDURE StringToNum (theString: Str255; VAR theNum: LONGINT); 


Assembly-Language Information 
Constants 
» Routine selectors 


numToString .EQU 0 
stringToNum .EQU 1 


Routines 
Name On entry On exit 
NumToString AQ: ptr to theString AQ: ptr to theString 


(preceded by length byte) 
DO: theNum (long) 
StringToNum AO: ptr to theString DO: theNum (long) 
(preceded by length byte) 


Trap Macro Name 


_Pack7 


END OF DOCUMENT 
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